home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
CD ROM Paradise Collection 4
/
CD ROM Paradise Collection 4 1995 Nov.iso
/
filutil
/
1sword20.zip
/
SWORD.DOC
< prev
next >
Wrap
Text File
|
1995-03-14
|
23KB
|
494 lines
SwordSearcher v2.0
Authorized King James Version
"...the sword of the Spirit, which is the word of God..." -Eph 6:17
The SwordSearcher software and documentation is copyrighted (c) 1995 by
Brandon Staggs, Imperative Software.
CONTENTS BY SECTION NUMBER:
1 Introduction
2 System Requirements
3 Shareware Notice
4 Legal Stuff
5 Distribution
6 Contacting the Author
7 Obtaining Site Licenses for Churches and Other Organizations
8 Use of Text Obtained from the use of SwordSearcher
9 General Use Instructions
10 Commands - Main Search Screen
11 Commands - Read Mode
12 Setting Search Keys
13 Case Sensitivity for Searches
14 Whole Words or Word-Within-Word Searches
15 Boolean Logic for Searches (OR/AND/XOR)
16 Using all the Options Together
17 Selecting Which Books to Search
18 Notes on Large Searches
19 Running SwordSearcher Under Windows
SECTION 1: Introduction
SwordSearcher is an integrated Bible and Concordance for your computer.
SwordSearcher is an easy-to-use, mouse driven, and intuitive Bible study and
research aid that doesn't sacrifice power for ease of use. SwordSearcher
allows you to search the Bible for any word, phrase, combinations of words
and/or phrases that you want. You have maximum control over the search.
Searches use boolean logic, can be case sensitive or ignore case, search for
substrings or find only whole words, it's all up to you. You can search the
Old or New Testament, the entire Bible, or any combination of books you
specify.
And it doesn't stop at the search. Your results are displayed in a
scrolling window, entire verses and references. The matching word, words,
and/or phrases are highlighted. This allows you to quickly scan for a verse
you need.
In this window, you can tag verses to save to a file or print directly to
your printer. You can simply point to a verse and click on it to go
directly to the passage of the Bible it appears in, and read as far forward
or backward you wish.
You can also browse the Bible in SwordSearcher's read-mode. You can save or
print any passages you want and set a bookmark, which remains there as long
as SwordSearcher is on your hard drive, or until you move it.
SwordSearcher allows your studies to become more productive. Once you use
SwordSearcher, you'll never want to page through a printed concordance
again.
SECTION 2: System Requirements
To run SwordSearcher, you must have: a 386 or better processor, 520K
conventional memory, at least 1 megabyte of Extended Memory (XMS), at least
2 megabytes of hard drive space, a Microsoft compatible mouse, and a VGA
display.
SwordSearcher will take advantage of systems with 5 megabytes of free XMS,
which will improve performance. For systems with less than 5 megabytes of
XMS, a disk cache is recommended. Some searches may require up to 5
megabytes of hard drive space to complete.
SECTION 3: Shareware Notice
SwordSearcher is distributed as shareware. Shareware is a
"try-before-you-buy" method of selling software. You may use this trial
version of SwordSearcher for up to one week to see if it meets your needs.
If you decide to keep using SwordSearcher, you must register (pay for) it.
If you choose not to pay for SwordSearcher, you must cease using it.
Please note that this trial version of SwordSearcher is identical in
function and operability to the registered (commercial) version. The author
believes that you should be able to use the product in its complete form
before you actually buy it. This system is based on your honor. Please
abide by this "license," in order to encourage the author's continued
support and development of this software. A laborer is worthy of his hire
(Luke 10:7).
Please read the file ORDER.DOC for registration instructions. If for some
reason you can't read this file, you can read the registration instructions
by viewing the help screen in SwordSearcher and selecting "Registration
Information."
SwordSearcher is only $29.50 + $3.50 s/h ($6 foreign). That's about the
cost of a printed Strong's Concordance. Upon registration, you will be sent
the latest version of SwordSearcher with the shareware notices removed on
3.5 HD floppies, a printed manual and quick-reference card, discounts on
upgrades and technical support information.
SECTION 4: Legal Stuff
SwordSearcher is provided AS IS, with no warranties expressed or implied.
The user of this software agrees not to hold the author or any distributors
accountable for any alleged damages of any kind caused by the use or misuse
of this software or anything related to this software. Use of this product
indicates agreement to these terms.
SECTION 5: Distribution
You are authorized, and even encouraged, to distribute this trial version of
the software, provided no modifications are made whatsoever to the software
or its accompanying documentation files, and provided that all of the files
listed in the MANIFEST.DOC file are included unmodified with the
distribution.
The shareware concept thrives on user distribution. Please share this
program with your friends and upload it to your favorite BBSs. You may not
charge for anything but a small duplication fee.
Shareware vendors have additional restrictions. Please see the VENDOR.DOC
file for more information.
If your company is interested in retail sale of the registered version, or a
future Windows or DOS commercial version, please contact me.
SECTION 6: Contacting the Author
I welcome your questions and comments. There are two ways to contact me.
The preferred way is through Internet e-mail. My Internet address is
<bstaggs@aloha.net> (without the brackets). You can send me surface mail
(postal service) at:
Brandon Staggs
Imperative Software
Po Box 1019
Hanalei, HI
96714
SECTION 7: Obtaining Site Licenses for Churches and Other Organizations
If you would like to obtain a license for a limited number of machines at
your Church or other organization, please contact me. I do give discounts
for these types of purchases. Please do not call the 1-800 credit card
order line with these enquiries. They can not, will not, and are completely
unable to answer such questions. You must contact me personally.
SECTION 8: Use of Text Obtained from the use of SwordSearcher
While using SwordSearcher you can obtain passages from the Bible in text
form. The author claims no rights on these texts. You may freely distribute
any text from the Bible that you obtain through the use of SwordSearcher,
trial or registered versions. In fact, you are encouraged to. The King
James Bible is not copyrighted.
SECTION 9: General Use Instructions
The following is an example of how to use SwordSearcher. Detailed
descriptions of commands and options are in following sections.
To start, run SwordSearcher.
Notice that if you have enough memory available, SwordSearcher will
decompress the Bible into XMS. This allows for much faster searches, and
much smoother book-to-book switching while in read-mode and examining
context. However, sometimes you may not want to wait for this (this can take
a while on slower machines), so you can just press ESCape and SwordSearcher
will skip the decompression.
You should now be at the main search screen. Here you will see three
windows and a "command strip." The upper-left window is where you configure
the search parameters. The upper-right window is where you select which
books you want SwordSearcher to search for the "Specific Books Search"
option. The bottom window is where all of the matching verses are
displayed.
In order to configure a search, you should first specify the "search keys."
To do this, either click on "Search string" with the mouse, or press F1.
For the purpose of this example, we will only specify one search key.
Enter "cain" as the search string (without the quotes). Use the mouse to
select "Okay" or press ENTER when you're done.
For this search, we want the search to be "substring inclusive." This means
we want SwordSearcher to count verses as matching when they contain the word
"cain" either as a whole word, or as part of a larger word. To set this,
use the mouse to click on the "[ ]" next to "Include Word-Within-Word," or
press F4 to toggle between Whole Word/Word-Within-Word.
We can leave all the rest of the options as they are.
To begin the search, either use the mouse to click on the "<B>" on the
command strip, or press B.
If the search parameters are all set, the search should begin.
SwordSearcher keeps you updated on the status of the search. It tells you
what book it is currently searching, and how many verses it has found so
far. At any time you can press ESCape to abort the search, and
SwordSearcher will display the verses (if any) it has already found.
Depending on the speed of your computer and whether or not you have extra
XMS, the search should be complete in just a few seconds up to about a
minute.
After the search is complete, you should see the verses in the New Testament
that contain the string "cain" in them. Notice that the word "cain" is
highlighted in each verse. The reference to each verse is on the left in a
different color.
In this search, the word "cain" is highlighted regardless of case (that is,
it doesn't matter if any letters are upper or lower case), and whether or
not it is a whole word, or just part of a larger word. You have control
over all of these options.
There is a "verse pointer" on the left of the lower window. This is just a
filled in arrow pointing right. If you only want to use the mouse, you can
ignore this arrow. However, if you use the keyboard's cursor positioning
keys (the arrow keys and the Page keys), this arrow is important.
To move this verse pointer, use the up and down arrow keys. You can also use
the page and home/end keys. See Section 10 for a detailed explanation of
each key. If there are more verses than fit in the window, the text will
scroll when the pointer is at the top or bottom and you press a key to move
it further.
Now, lets examine the context of one of the verses. There are several ways
to do this. You can use the mouse by pointing to the verse you want, and
clicking the LEFT mouse button. Or, you can move the verse pointer to the
verse you want and press one of several keys. For this example, press the
RIGHT ARROW key. Please note that if you point at a blank space (either
with the mouse or the verse pointer), nothing will happen when you try to
examine the context. You must be pointing at actual text.
You should now be in "read-mode." The reference to the verse you are
examining should be flashing. In this mode, you can scroll the text forward
or backward to read as much of the passage as you like. There are commands
for switching to other books too, explained in Section 11.
After you read what you need to, you can go back to the main search screen
either by pressing Q or the LEFT ARROW, or by using the mouse and clicking
on the "<Q>" in the command strip. There are other commands for exiting
read-mode, explained in Section 11.
You should be back on the main screen right where you left off.
Now let's tag a verse to print it (this, of course, assumes you have a
printer attached to your computer). To tag a verse, you can use the mouse
to point at the verse (the same way you do for examining the context of a
verse) and clicking the RIGHT mouse button. You can also move the verse
pointer to the verse you want to tag and use the mouse to click on the "<T>"
in the command strip, or press T, or press SPACE.
When you tag a verse, the reference will change color so you can easily tell
which verses are tagged.
Now, lets print this verse. Either use the mouse to click on the "<P>" in
the command strip, or press P. If you don't have a printer, or your printer
is off-line or out of paper, the message "Printer Unavailable" will appear.
If you have a printer, you will be presented with a choice. You can either
print the tagged verses, the untagged verses, or all of the verses. Make
your choice with either the mouse or the keyboard (you should be fairly
comfortable with the controls by now).
If you have a dot-matrix printer, you should have heard that annoying
screech and see the verse or verses on the paper. If you have a bubble-jet
or laser printer, chances are nothing happened. The reason for this is
that in order for a laser printer to spit out the page, it either has to
have a full page of information to print, or a form-feed command. Look in
your printer manual if you don't know how to issue a form-feed command on
your printer's control console.
The reason SwordSearcher does not automatically issue form-feeds is so you
can do multiple searches and prints without wasting tons of blank space on
paper. This way, all the verses are printed one after another without
wasting paper. So, you should always check to make sure your printer has
spit out all the verses you wanted before you turn it off. (Most laser
printers have a flashing FF light to warn you.)
Now you have sampled just a small portion of SwordSearcher's commands and
abilities. The best way to learn the rest of SwordSearcher's commands are
through experimentation and reading the rest of this manual.
SECTION 10: Commands - Main Search Screen
Mouse:
Click on any "[ ]" to toggle option.
Click on any "< >" to activate command.
LEFT click on a verse to examine its context.
RIGHT click on a verse to toggle tag on/off.
Keyboard:
[F1] Change search string
[F2] Toggle case sensitive
[F3] Toggle OR/AND/XOR search
[F4] Toggle word-within-word
[F5] Toggle Entire/New/Old/Specific book search
[F9] Toggle all books in upper-right window ON for specific book search
[F10] Toggle all Old Testament books in upper-right window ON for specific
book search
[F11] Toggle all New Testament books in upper-right window ON for specific
book search
[F12] Toggle all books in upper-right window OFF for specific book search
[Q] Quit SwordSearcher
[R] Go into read-mode for Bible browsing
[B] Begin Search
[S] Save results to a file
[P] Print results
[H] Help screen
[C] [ENTER] Examine the context of the verse pointed to by the verse pointer
[T] [SPACE] Toggle tag on/off of the verse pointed to by the verse pointer
[CTRL-T] Toggle all verse tags on/off
[CTRL-U] Untag all verses
[ALT-X] Quick quit
[UP ARROW] Move verse pointer up one line
[DOWN ARROW] Move verse pointer down one line
[PAGE UP] Move verse pointer up one page
[PAGE DOWN] Move verse pointer down one page
[HOME] [CTRL-PAGE UP] Move verse pointer to the first verse in the list
[END] [CTRL-PAGE DOWN] Move verse pointer to the last verse in the list
[CTRL-UP ARROW] Move the verse pointer to the first line on the current page
[CTRL-DOWN ARROW] Move the verse pointer to the last line on the current
page
[RIGHT ARROW] Examine the context of the verse pointed to by the verse
pointer
SECTION 11: Commands - Read Mode
Mouse:
Click on any "< >" to activate command.
Keyboard:
[Q] [ESC] Quit reader
[M] Set bookmark on current page
[B] Go to bookmark
[G] Go to a passage
[S] Save a passage to a file
[P] Print a passage
[H] Help screen
[DOWN ARROW] Scroll Scripture forward
[UP ARROW] Scroll Scripture backward
[PAGE DOWN] Page Scripture forward
[PAGE UP] Page Scripture backward
[HOME] [CTRL-PAGE UP] Go to the beginning of the current book
[END] [CTRL-PAGE DOWN] Go to the ending of the current book
[CTRL-UP ARROW] [CTRL-LEFT ARROW] Go to the preceding book
[CTRL-DOWN ARROW] [CTRL-RIGHT ARROW] Go to the next book
[LEFT ARROW] Quit reader
SECTION 12: Setting Search Keys
SwordSearcher allows you to specify up to ten words and/or phrases to search
for. Each word or phrase is considered a search "key." If you want to
search for more than one word or phrase, you must separate them with a slash
("/").
For example, if your want to search for "Abel," "Cain," "Adam," and "Eve,"
your search string would be "Abel/Cain/Adam/Eve" (without the quotes). You
can also do phrases. For example, "Lord of Lords". You can also do
multiple phrases, like "Lord of Lords/King of Kings". You can combine
phrase and word searches, like "Lord of Lords/Christ". You can have up to
ten keys altogether.
SECTION 13: Case Sensitivity for Searches
SwordSearcher allows you to configure your searches to be case sensitive, or
non-case sensitive. A case sensitive search means that the search keys have
to match the case (upper/lower case letters) of the word(s) in the verse.
For example, a case sensitive search for "God" would return only verses with
upper-case "God." A non-case sensitive search for "God" would return words
like "God" and "god." Note that case sensitivity is not restricted to the
first letter. A case sensitive search for "GoD" is not likely to turn up
anything.
SECTION 14: Whole Words or Word-Within-Word Searches
SwordSearcher allows you to configure your searches to be "substring
inclusive." This means that you can configure your search to include matches
where the key is a part of a larger word in the verse. Or, you can have
your search be "whole words only."
For example, if you did a "whole words only" search for "god," the search
would only count verses as matching when "god" is a whole word in the verse.
If you did a "word-within-word" search for "god," your results would include
words like "god," "ungodly" and "godly."
Word-within-word searches for phrases work too. For example, if you did a
word-within-word search for "lord of lord", the search would find "lord of
lords." However, it would NOT find a phrase like "lords of lord," even if
there were such a phrase in the Bible.
SECTION 15: Boolean Logic for Searches (OR/AND/XOR)
SwordSearcher uses "boolean logic" in its searching. You have three
"operators" you can choose from in configuring your search: OR, AND, and XOR
(exclusive or). For example, take the search string "Abel/Cain". The
search keys in this string are "Cain" and "Abel".
OR search: An OR search would find verses which have either "Cain", "Abel",
or both "Cain" and "Abel" in them. In other words, an OR search returns
verses that have at least one of the search keys in them.
AND search: An AND search would find verses which have both "Cain" and
"Abel" in them. In other words, an AND search returns verses that contain
ALL of the search keys in them.
XOR search: An XOR search would find verses which have either "Cain" or
"Abel" in them, but NOT with BOTH "Cain" and "Abel" in them. In other
words, an XOR search returns verses which have ONLY ONE of the search keys
in them. If a verse has more than one of the search keys in them, the verse
is NOT a match.
SECTION 16: Using all the Options Together
SwordSearcher gives you maximum control over your searches. All of the above
options always work in conjunction which each other. The best way to get
the hang of this is through experimentation.
SECTION 17: Selecting Which Books to Search
SwordSearcher allows you to search the books of the Bible however you wish
in any combination.
Select "Search Entire Bible" to search every book of the Bible. Select
"Search Old Testament" to search only the books of the Old Testament. Select
"Search New Testament" to search only the books of the New Testament.
Select "Search Specific Book(s)" to search only the books you specify in the
upper-right window. Select which books you want searched in a specific book
search by clicking on the "[ ]" next to the book you want searched in the
upper-right window. Click on it again to deselect it. You can select as
many or as few books as you want. You can also use the keys explained in
Section 10 to select specific books.
SECTION 18: Notes on Large Searches
SwordSearcher uses your hard disk as a temporary storage space for the
results of the search. You should keep this in mind when (and if) you do
unusually long searches like the word "the." These types of searches require
considerable amounts of hard drive space (and time) to complete.
To give you an idea, if you did a word-within-word, non-case sensitive,
entire Bible search for the letter "e," the search would require about 5.5
megabytes of hard drive space to complete. The more results there are, the
larger the space required.
SECTION 19: Running SwordSearcher under Windows
SwordSearcher, if installed properly, will run just fine (if a bit slower)
under Microsoft Windows. SwordSearcher includes a .PIF (program information
file) and a .ICO (icon) file for Windows. Please see your Windows
documentation for instructions on installing a DOS program into Windows.
DO NOT run more than one copy of SwordSearcher at a time under Windows,
unless you have them in separate directories. SwordSearcher does not "share"
its data files with multiple instances of itself, and will not run.
You should not allocate more than 1 megabyte of XMS for SwordSearcher under
Windows unless you have an enormous amount of memory and you "lock"
SwordSearcher's XMS memory in the PIF. SwordSearcher will usually just slow
down if you do. For details on all of this, see your Windows documentation.
SwordSearcher has been designed to run in DOS. It runs satisfactorily under
Windows, but not as fast and not as well. There will most likely be a future
Win95 version of SwordSearcher. Feel free to send your suggestions for
future versions to the author.